# HEIC to JPG Browser Converter
Project File and Changelog

## Project Summary

A browser-based HEIC/HEIF to JPG converter. The goal is to keep the entire conversion process local in the user's browser so image files are not uploaded to a server.

Current baseline: Version 1.0

## Core Privacy Position

- All selected image files are processed in the browser.
- HEIC/HEIF files are not uploaded by the tool.
- ZIP extraction happens locally in the browser.
- JPG output is generated locally.
- The current version may load JavaScript libraries from a CDN, but the user's image files remain local.

## Current App File

- HEIC to JPG Browser Converter ZIP Support.html

## Current Logo File

- heic_to_jpg_conversion_icon.png
- Intended use: 64 x 64 px app/logo/favicon style image

---

# Changelog

### Version 1.1 UI Refinement - Mass Rename Auto Enable

### Status
Released as an update within v1.1.

### Changes
- Rename controls now appear visually inactive until mass rename is enabled.
- If the user types in the prefix, start number, digit padding, or separator fields, the mass rename checkbox automatically turns on.
- This prevents entering a rename pattern and then accidentally downloading original filenames because the checkbox was missed.
- ZIP filename remains editable without forcing mass rename, since that controls only the downloaded ZIP file name.
- App version remains v1.1.

---


## Version 1.1 - Mass Rename Before Download

### Status
Released.

### Features Added
- Added optional mass rename controls before downloading.
- Users can keep original converted JPG names or enable a batch naming pattern.
- Added filename prefix field.
- Added starting number field.
- Added digit padding field.
- Added separator field.
- Added custom ZIP filename field.
- Added live filename example.
- Individual JPG download buttons and the Download All ZIP use the mass rename pattern when enabled.

### Notes
- Original HEIC/HEIF source filenames are not changed.
- Rename only affects downloaded JPG filenames.
- Conversion and ZIP creation remain browser-only.

---


## Version 1.0 - Baseline Release

### Status
Released / baseline locked.

### Features
- Browser-based HEIC/HEIF to JPG conversion.
- Drag and drop file upload area.
- Supports selecting loose `.heic` and `.heif` image files.
- Supports uploading `.zip` files.
- Extracts HEIC/HEIF files from ZIP archives locally in the browser.
- Converts images to JPG locally.
- JPG quality adjustment.
- Preview thumbnails for converted files.
- Individual JPG download links.
- Download all converted JPGs as a ZIP.
- Clear privacy messaging that files are not uploaded.

### Notes
- The tool currently depends on external browser libraries for HEIC decoding and ZIP handling.
- Because of those library dependencies, internet access may be required for the page code unless the libraries are bundled locally in a future version.
- Image files themselves are not uploaded by the tool.

---

# Pending / Future Ideas

These are not implemented yet.

## Possible Version 1.1 Ideas
- Bundle all JavaScript libraries locally so the tool can work fully offline.
- Add the 64 x 64 px logo into the HTML page and favicon.
- Add better progress feedback for large ZIP files.
- Add file count summary before conversion.
- Preserve folder names from ZIP files in output JPG names.
- Add error details when a specific HEIC file fails to convert.
- Add a simple "About / Privacy" section.
- Add a "Clear all files" button.
- Add dark mode or more polished styling.

## Possible Version 1.2 Ideas
- Add PNG output option.
- Add resize option.
- Add remove metadata option.
- Add batch filename prefix/suffix option.
- Add option to keep original file modified date if technically possible.
- Add offline/PWA install support.

---

# Development Rules

- Keep the app browser-only.
- Do not add server upload behavior.
- Keep privacy wording clear and visible.
- Keep the tool simple enough for non-technical users.
- Use plain, friendly UI language.
- For future releases, update this changelog and bump the version number.